Resource URL: /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>

    Overview: Retrieve a file count histogram according to the STAT parameter.

     Methods: GET

********************************************************************************

Method GET: This resource retrieves a histogram of file counts for an
            individual FSA result set. ID in the resource path is the result
            set ID.

       URL: GET /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>

Query arguments:
 directory_filter=<string> Filter according to a specific directory, which
                           includes all of its subdirectories.
 attribute_filter=<string> Filter according to the name of a file user
                           attribute.
 node_pool_filter=<string> Filter according to the name of a node pool, which
                           is a set of disk pools that belong to nodes of the
                           same equivalence class.
 disk_pool_filter=<string> Filter according to the name of a disk pool, which
                           is a set of drives that represent an independent
                           failure domain.
      tier_filter=<string> Filter according to the name of a storage tier,
                           which is a user-created set of node pools.
     comp_report=<integer> Result set identifier for comparison of database
                           results.
 log_size_filter=<integer> Filter according to file logical size, where the
                           filter value specifies the lower bound in bytes to a
                           set of files that have been grouped by logical size.
                           The list of valid log_size filter values may be
                           found by performing a histogram breakout by log_size
                           and viewing the resulting key values.
phys_size_filter=<integer> Filter according to file physical size, where the
                           filter value specifies the lower bound in bytes to a
                           set of files that have been grouped by physical
                           size. The list of valid phys_size filter values may
                           be found by performing a histogram breakout by
                           phys_size and viewing the resulting key values.
  path_ext_filter=<string> Filter according to the name of a single file
                           extension.
    ctime_filter=<integer> Filter according to file modified time, where the
                           filter value specifies a negative number of seconds
                           representing a time before the begin time of the
                           report. The list of valid ctime filter values may be
                           found by performing a histogram breakout by ctime
                           and viewing the resulting key values.
    atime_filter=<integer> Filter according to file accessed time, where the
                           filter value specifies a negative number of seconds
                           representing a time before the begin time of the
                           report. The list of valid atime filter values may be
                           found by performing a histogram breakout by atime
                           and viewing the resulting key values.

GET response body schema:
{
  "type": "object", 
  "properties": {
    "atime_enabled": {
      "required": true, 
      "type": "boolean", 
      "description": "Access time enabled."
    }, 
    "histogram": {
      "items": {
        "type": "object", 
        "properties": {
          "bucket": {
            "required": true, 
            "type": "integer", 
            "description": "Bucket for holding file counts within a range."
          }, 
          "value": {
            "required": true, 
            "type": "integer", 
            "description": "Number of files within the bucket."
          }
        }
      }, 
      "required": true, 
      "type": "array", 
      "description": "Histogram data of specified file count parameter."
    }, 
    "attribute_count": {
      "required": true, 
      "type": "integer", 
      "description": "User attribute count."
    }, 
    "begin_time": {
      "required": true, 
      "type": "integer", 
      "description": "Unix Epoch time of start of results collection job."
    }
  }
}
